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PREFACE 


8TRAN is a special purpose program designed to assist PDP-8 users in converting 
software for operation on the PDP-15. It is assumed that the programmer who 
wishes to use 8TRAN is completely familiar with the PDP-8 and PDP-15 documen- 
tation listed below. 
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CHAPTER 1 
INTRODUCTION 


PDP-15 8TRAN is a relocatable program which assists in the translation of PDP-8 programs to PDP-15 programs. 
8TRAN accepts source coding in PAL-III, PAL-D, or MACRO -8 assembly languages and produces source code in 
MACRO-15 or CAP-15 assembly languages. Its main functions are: 

Re-formatting of statements 
Translation of mnemonics 

Insertion of flags to indicate either that instructions have been translated or that translation is 
impossible. 


NOTE 

EAE coding and any input/output instructions other than 
those for the reader/punch and Teletype must be modi- 
fied. Floating point instructions are translated to con- 
form to the PD P-1 5/10 COMPACT Software System. 
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CHAPTER 2 
INSTRUCTION SETS 


2. 1 MEMORY REFERENCE INSTRUCTIONS 

Table 2-1 shows the correspondence between the two sets. 


Table 2-1 

Correspondence Between Memory Reference Instructions 


PDP- 

•8 

PDP-15 

Mnemonic 

Octal 

Mnemonic 

Octal 

AND 

0000 

AND 

500000 

TAD 

1000 

TAD 

340000 

ISZ 

2000 

ISZ 

440000 

JMS 

4000 

JMS 

100000 

JMP 

5000 

JMP 

600000 

DCA 

3000 

DAC 

CLA 

040000 



CAL 

000000 



DZM : 

140000 



LAC 

200000 



XOR 

240000 



ADD 

300000 



XCT 

400000 



SAD 

540000 


2.2 INDIRECT REFERENCES AND AUTO-INDEX REGISTERS 
Single level indirect addressing is identical on both machines. 



PDP-8 


1 PDP-15 

I 


0400 

* 

020000 
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The Auto-Index Registers (10-17) also operate identically. However, the PDP-8 has one set of Auto Index 
Registers for each 8K memory field, while the PDP-15 has only one set of Auto Index Registers in Page 0 of 
Bank 0. 


2.3 OPERATE INSTRUCTIONS 

A single group of Operate instructions in PDP-15 corresponds to the two groups in PDP-8, as shown in Table 2-2. 


Table 2-2 


Correspondence Between Operate Instructions 


PDP-8 

PDP-15 

Group 1 

NOP or OPR 

7000 

NOP or OPR 

740000 


CLA 

7200 

CLA 

750000 


CLL 

7100 

CLL 

744000 


CMA 

7040 

CMA 

740001 


CML 

7020 

CML 

740002 


RAR 

7010 

RAR 

740020 


RAL 

7004 

RAL 

740010 


RTR 

7012 

RTR 

472020 


RTL 

7006 

RTL 

742010 


lAC 

7001 

lAC 

740030 

Group 2 

CLA 

7600 

CLA 

750000 


SMA 

7500 

SMA 

740100 


SZA 

7440 

SZA 

740200 


SNL 

7420 

SNL 

740400 


SPA 

7510 

SPA 

741100 


SNA 

7450 

SNA 

741200 


SZL 

7430 

SZL 

741400 


SKP 

7410 

SKP 

741000 


OSR 

7404 

OAS 

740004 


HLT 

7402 

HLT 

740040 


2.4 LAW INSTRUCTION 

The LAW instruction in PDP-15 has no equivalent in PDP-8. The mnemonic LAW N has an octal value of 760000 


2.5 PAGING 

The address portion of Memory Reference Instructions consists of 8 bits on the PDP-8 and 12 bits on the PDP-15, 
permitting direct addressing of 4K on the PDP-15. 


Using indirect address references, the address size is 12 bits in PDP-8 and up to 15 bits in PDP-15, so that data 
and instruction fields are not required in PDP-15. 
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CHAPTER 3 
ASSEMBLERS 


The symbolic programs acceptable to PAL IIl/MACRO-8 and to MACRO- 15 are similar in most respects. The 
important differences which do exist are discussed in this chapter. 


3.1 FORMAT 

The MACRO-15 Assembler is field-oriented, which means that the interpretation of a statement depends on the 
field in which each element of the statement lies. There are four fields: 


LABEL 

OPERATION 

ADDRESS 

COMMENT 


(Field delimiter) 
(Field delimiter) 
(Field delimiter) 
(Statement delimiter) 


A field delimiter is either a space or a tab. A statement delimiter is either a carriage return or a semicolon. In 
this document, tabs are indicated with the symbol , and carriage returns are indicated with 


In MACRO-15, there is no field for an indirect reference because indirect addressing is indicated by an asterisk 
(*) immediately following the mnemonic operator in the operation field. 


Examples: 


PDP-8 

PDP-15 

TAD A 

TAG H TAD 

ISZ I B 

Hisz* 

JMP C 

H JMP 


HA 

HB 

He 


Tabs are normally preferred to spaces as field delimiters. MACRO-15 does not require commas to terminate labels. 
Labels appearing on successive lines without any code are given consecutive addresses by MACRO-15, not the 
same address; an important difference from the PDP-8 assembler. 
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3.2 SYMBOLS 


Symbols in AAACRO-15 may use period (.) and percent sign (%) in addition to letters and numbers. The initial 
character must be a letter, period (.), or percent sign (%). 

3.3 EXPRESSION OPERATORS 

MACRO-15 has a more extensive set of operators. Addition (+), Subtraction (-), AND (&), and Inclusive OR 
(!) are supplemented by Exclusive OR C\)/ Multiplication (*), and Division (/). 

3.4 NUMBERS 

18 17 

Octal and decimal numbers in the range ±2 -1 for unsigned integers and ±2 -1 for signed integers are avail- 

able in AAACRO-15. Double precision and floating-point constants (DUBL and FLTG pseudo-ops of MACRO-8) 
are not permitted in MACRO- 15. 

3.5 LOCATION COUNTER 

The Location Counter may be referenced by period (.) in both systems. It is set as follows: 


PDP-8 


n 

PAGE n 


PDP-15 


.LOC n 
Ignored 

Paging is redundant in 
PDP-15 


The Location Counter is advanced as follows: 


PDP-8 

PDP-15 

* . + n 

• BLOCK 


The .BLOCK pseudo-op makes the operation more explicit in PDP-15. 

3.6 TEXT HANDLING 

Pseudo-ops to perform packing of 6-bit trimmed ASCII characters are available in both systems. 


PDP-8 

PDP-15 

TEXT 

.SIXBT 
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The 18-bit word in PDP-15 permits 3 characters per word, as compared with 2 characters per word in PDP-8. 

An additional pseudo-op which performs the packing of five 7-bit ASCII characters in two words (.ASCII) is 
available in PDP-15. 


3.7 TERMINATING PSEUDO-OPS 

The correspondence between the two systems is: 


PDP-8 

PDP-15 

PAUSE 

.EOT 

$ 

.END 


3.8 LITERALS 

Page zero literals have no meaning in PDP-15. The correspondence is: 


PDP-8 

PDP-15 

[ 

( 

( 

( 

] 

) 

) 

) 


It should be noted that neither nested literals, e.g., TAD (TAD (20)), nor 8-bit ASCII characters, e.g., TAD 
("A), are allowed in MACRO-15. 


3.9 SYMBOL TABLE 

The Symbol Table of MACRO-15 cannot be deleted, hence EXPUNGE is not a valid pseudo-op. 

Since the permanent Symbol Table of MACRO-15 is searched for octal matching and not symbol matching the 
pseudo-ops FIXMRI and FIXTAB are redundant. A memory reference instruction is defined by a parameter assign- 
ment, e.g., IDX=ISZ, or I DX =440000. 


3.10 USER MACROS 

User Macros can be more elaborate in AAACRO-15. The correspondence between the sets is: 


PDP-8 


DEFINE 

< 

> 


PDP-15 


.DEFIN 
Not used 
.ENDM 
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Example: 


PDP-8 

PDP-15 

DEFINE SUB A B 

.DEFIN 

< CLA 

LAC 

TAD B 

CMA 

CIA 

TAD 

TAD A> 

TAD 

.ENDM 


SUB A,B 
B 

(1 

A 
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CHAPTER 4 
INPUT/OUTPUT 


The most important difference between the PDP-8 and the PDP-15 in I/O lies in the fact that an extra 3 bits 
(12-14) are available in the PDP-15 instruction word. 

Bits 12 and 13 are used for subdevice selection, and Bit 14, when set, clears the AC at event time 1; i.e., prior 
to transfers to/from the AC. 

4.1 FLAGS 

The PDP-15 has two instructions, not available on PDP-8, which read and clear flags. 

lORS Input/Output Read Status 

CAF Clear All Flags 


4.2 INTERRUPT 

The interrupt structure is identical on both machines. When the interrupt function is enabled (ION), the setting 
of a flag will cause an interrupt; i.e. , an effective JMS to location 0 of field 0. 

The PDP-15 has an 18-bit word so that the full 15-bit address of the interrupt location is stored, eliminating the 
need for the 6-bit Interrupt Buffer in the PDP-8. 

The remaining 3 bits of the PDP-15 word are used to store the state of the Link, Bank/Page Mode, and Memory 
Protect. 


PDP-15 


L 

BPM 

MP 

ADDRESS (15-Bits) 

0 

1 

2 

3-17 
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4.3 TELETYPE 




There are two differences in the lOT instructions between PDP-8 and PDP-15. 


KCC does not exist on the PDP-15. The Keyboard Flag is cleared by issuing a KRB, which also reads the buffer. 


KRS (only recognized in the PDP- 15/10 COMPACT System) performs the function of Keyboard Reader Select, a 
facility not available in PDP-8. 


PDP-8 


PDP-15 


KCC 

KRS 


None (use KRB) 

None (use KRB) 

KRS (Keyboard Reader Select) 


All other Teletype lOTs are identical. 


4.4 READER/PUNCH 

All reader/punch functions available on the PDP-8 are also available on the PDP-15. The PDP-8 operates in 
Alphanumeric mode only, while the PDP-15 operates in Binary mode as well as Alphanumeric mode. (Binary 
permits the reading of an 18-bit word from 3 lines of tape and the punching of a single line in the format of the 
binary read.) 


PDP-8 

PDP-15 

RSF 

RSF 

RRB 

RRB 

RFC 

RSA 

— 

RSB 

PLS 

PSA 

— 

PSB 

PCF 

PCF 

PSF 

PSF 


4.5 DECTAPE 

The DECtape controllers, TCOl on PDP-8 and TC02 on PDP-15, work in an identical manner. 


The standard format of data on the tape differs significantly (see Table 4-1). There is, however, no incompati- 
bility of control word format; therefore, a standard block of 129 words written by the PDP-8 can be read as a 
block of 86 words by the PDP-15. 




eletype is the registered trademark of Teletype Corporation. 
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Table 4-1 

Tape Standard Data Format 



PDP-8 

PDP-15 

Words 
per Block 

12910 

(12 bits) 

25610 
(18 bits) 

Blocks 

0-270 1q 

O-llOlg 

Address of 

Word Count 

7754 

30 

Address of 

Current Address 

7755 

31 


The instructions to the two controllers differ in only one respect. The single lOT DTSF (skip if error flag or DEC- 
tape control flag=l) In the TCOl is replaced by the two lOTs, DTDF (skip if DECtape control flag=l) and DTEF 
(skip if DECtape error flag=l), on the TC02. 

The two Status Registers, A and B, are 12 bits on both machines (ACq on the PDP-15). 

4.6 lOTs IN PERMANENT SYMBOL TABLE 

MACRO-15 assumes that input/output will be handled by I/O System Macros using device handlers. Device- 
dependent lOTs are therefore not included in the Symbol Table. The P (parameter) option in MACRO-15 provides 
the facility for adding to the Symbol Table prior to an assembly; lOTs may always be assigned in this manner if 
required. 
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CHAPTER 5 

EXTENDED ARITHMETIC ELEMENT 


Any EAE coding for fhe PDP-8 should be rewritten for the PDP-15, since: 

a. The word length on the two machines is different. 

b. The PDP-15 EAE is considerably more powerful than its PDP-8 counterpart. 
Table 5-1 indicates the correspondence between the two instruction sets. 

Table 5-1 

Correspondence Between Instruction Sets 


PDP-8 

PDP-15 

DVI 

DVI 

NMI 

NORM 

SHL 1 

N J 

LLS+N+1 

ASR 1 

N J 

LRSS+N+1 

LSR \ 

N J 

LRS+N+1 

MQL 

LMQ 

MUY 

MUL 

MQA 

OMQ 

CAM 

CLQ 

SCA 

OSC 


5. 1 MULTIPLICATION AND DIVISION 

Signed operations (MULS and DIVS) are available on PDP-15. The full number of shifts is always performed in 
multiplication and division on PDP-8. The number of shifts in PDP-15 is programmable (contained in bits 12-17 
of the instruction word) to reduce execution time where numbers are less than 18 bits in magnitude. 
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In division, the high order part only or the lower order part only of the dividend may be used in the operation as 
alternatives to the usual double word operation. 

ODIV, IDIVS, FRDIV, FRDIVS) 


5.2 SHIFTING 

Three additional shifting operations are available on PDP-15. They are: 

a. Signed left shift (LLSS) 

b. Accumulator left shift (ALS) 

c. Signed accumulator left shift (ALSS). 


5-2 



CHAPTER 6 
FLOATING-POINT ARITHMETIC 


Bofh the format and the treatment of floating-point numbers are different on the two machines. 


6.1 FORMAT 


PDP-8 


PDP-15 


Three -word 


Two-word 


SIGN 


SIGN 



Exponent 

2s Comp 

0 1 

11 


High-Order 


Mantissa 

0 1 

11 


Low-Order 


Mantissa 

0 

11 


Mantlssae are in 2s complement 


SIGN 


Low-Order Exponent 

Mantissa 

2s Comp 

0 


89 17 


High-Order 

Mantissa 

0 1 

17 


Three -word 


SIGN 


Exponent 

2s Comp 

0 

17 


High-Order 


Mantissa 

0 1 

17 


Low Order 


Mantissa 

0 

17 


Negative mantissae are indicated 
by setting bit 0 of the high-order 
word (i.e, Sign-Magnitude nota- 
tion) 
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6.2 ARITHMETIC PACKAGE 


The PDP-8 performs floating-point arithmetic by use of an interpreter. The PDP-15 uses subroutine calls to 
perform its arithmetic, the address of the argument being in the location following the JMS. Indirect addresses 
are indicated by setting bit 0 of the word (i.e., XCT). 

The correspondence between the two systems is shown in Table 6-1 . 


Table 6-1 

Correspondence Between Arithmetic Packages 


PDP-8 

PDP-15 

JMS 17 (Enter Interpreter) 

None (not- interpretive] 

FADD A 

JMS Hfad 

A 

FSUB I B 

JMS Hfsub 

XCT Hb • 

FMPY 

JMS Hfmpy 

FDIV 

JMS Hfdvd 

FGET 

JMS HFLAC 

FPUT 

JMS Hfdac 

FNOR 

JMS H%fnor 

FEXT 

None (not interpreted) 


6.3 INPUT/OUTPUT 

The PDP-15/10 COMPACT system has an I/O package similar to that of the PDP-8. Numbers are input to and 
output from the floating accumulator. 

The subroutine call for the PDP-15/10 is followed by an argument. On input, bit 0 of the argument indicates 
the input device (other bits are ignored). On output, bit 0 indicates the output device, the other bits indicate 
the number of digits in the mantissa output. 

PDP-8 PDP-15 

JMS I 5 f JMS H FLIP 

I 0 

JMS I 6 (JMSHFLOP 

6 

Floating-point constants must be changed, and where FLTG is used in MACRO-8 the appropriate octal numbers 
must be inserted. 
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Examples: 


Decimal 

PDP-8 

PDP-15 

0.1 

7775 

460775 


3146 

314631 


3146 


-7.0 

0003 

000003 


4400 

740000 


0000 


ir 

0002 

550002 


3110 

311037 


3755 


5.0 

FLTG 5.0 

000003 



240000 
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CHAPTER 7 
TRANSLATOR FUNCTIONS 


The Translafor program accepts a symbolic source tape (or file) written in either PAL III, PAL D, or MACRO -8, 
and translates it to MACRO-15 or CAP-15 assembly language, within the limits described below. 


7.1 FORMATS 

Each statement is re-formatted in MACRO-15 format. The Translator inserts a tab after a label field and after 
the operation field, so that the MACRO-15 listing appears in columns as shown in the examples below. 


PDP-8 


TAG, C LA CMA 
TAD I Z AUTO 


TAG 


PDP-15 


CLAiCMA 
TAD* AUTO 


[The optional page zero indicator (Z) is ignored.] 


7.2 TRANSLATION 

The following translations are performed. (Mnemonics processed by the Translator, and their translation where 
appropriate, are listed in Appendix A.) 


7.2.1 Memory Reference Instructions 


PDP-8 

PDP-15 

DCA LOC 

Jdac 


\CLA 


Where DCA is followed by TAD, the CLA in the above translation may sometimes be eliminated. The Translator 
treats the situation in one of three ways: 
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PDP-8 

PDP-15 

DCA LOC 

DAC 

LOC 

TAD LOC 



DCA LOCI 

DAC 

LOCI 

TAD LOC2 

LAC 

LOC2 

DCA LOC 

DAC 

LOC 

TAG, TAD LOC 

CLA 



TAG TAD 

LOC 


In the last example above, the CLA is not eliminated because the TAD is labelled. 


Where successive DCAs are translated, DZM replaces each DCA after the first, terminating the last DZM with a 
CLA. If a DCA is tagged, however, DZM is not generated. 


PDP-8 

PDP-15 


DCA LOCI 

DAC 

LOCI 

DCA LOC2 

DZM 

LOC2 

DCA LOC3 

DZM 

LOC3 

TAG, DCA LOC4 

CLA 


JMP LOC5 

TAG DAC 

CLA 

LOC4 


JMP 

LOC5 


All other MRIs are transferred without change. 


7.2.2 Input/Output Instructions 


PDP-8 

PDP-15 

RFC 

RSA 

PLS 

PSA 


All other Teletype and reader/punch instructions are transferred without change. lOT instructions for other de~ 
vices are declared undefined symbols (see Paragraph 7.3. 1 .4). 
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7.2.3 Operate Instructions 


PDP-8 

PDP-15 

lAC 

lAC 

CLA lAC 

CLAIIAC 

CIA 

CMAIIAC 

CLL RTL 

CLL 


RTL 

OSR 

OAS 

CLA OSR 

LAS 


In addition to separating double-rotate instructions from other instructions because of conflicting event times, 
single-rotate instructions are also separated when they conflict. 


7.2.4 Pseudo-Operations 


7. 2.4.1 Miscellaneous 


PDP-8 

PDP-15 

DECIMAL 

.DEC 

OCTAL 

.OCT 

PAUSE 

.EOT 

$ 

.END 


The PDP-8 pseudo-ops PAGE and * for setting the location counter are not translated. 

7. 2.4.2 Text Handling 


PDP-8 

PDP-15 

TEXT 

.SIXBT 


Both .SIXBT in MACRO-15 and TEXT in PDP-8 assemblers treat text strings as trimmed ASCII. MACRO-15 stores 
three characters per 18-bit word. 


7. 2. 4.3 Macro Defining - The left angle bracket (<), used in MACRO-8, is ignored. However, instructions 
within a macro are translated. Since there is no macro facility in the CAP- 15 Assembler, the 4K COMPACT 
version of 8TRAN ignores macro definitions. (Macro names, DEFINE or < > will be flagged as undefined symbols 
when encountered . ) ^ 
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PDP-8 

PDP-15 

DEFINE 

.DEFIN 

< 

ignored 

> 

,ENDM 


7.2.5 Literals 


PDP-8 

PDP-15 

[ 

( 

] 

) 

("N 

(nnn 


Page 0 literals are translated as ordinary literals. Instructions within literals are translated. ASCII characters 
are translated into their 7-bit octal equivalent. 


7.2.6 Floating Point 


PDP-8 

PDP-15 

FEXT 

Ignored 

FADD 

JMS H FAD 

FSUB 

JMS H FSUB 

FMPY 

JMS -Hfmpy 

FDIV 

JMS Hfdvd 

FGET 

JMS Hflac 

FPUT 

JMS H FDAC 

FNOR 

JMS H%fnor 

I 

XCT 

JMS I 5 

JMS HFLIP 


0 

JMS I 6 

JMS Hflop 


6 

JMS I 7 

Ignored 


The calls to the Input/Output routines (JMS I 5 and JMS I 6) and the entry to the interpreter (JMS I 7) are 
frequently given other names by parameter assignment. Where these instructions occur in a parameter assignment, 
the following translations occur. 
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PDP-8 


PDP-15 


JMS I 5 
JMS I 6 
JMS I 7 


JMS HFLIP 
JMS Hflop 
NOP 


The arguments of JMS FLIP and JMS FLOP are dropped and any entry to the interpreter is effectively ignored. 
However, the input and output calls must be followed by arguments, so insertion would have to be made at ap- 
propriate points in the program. 


Floating-point variable storage can be reduced by one location for each variable, but no program error will oc- 
cur if this is not done. 


7.3 FLAGS 

Flags are inserted to signal translations (or the absence of a translation) which may result in incorrect operation 
when assembling on the PDP-15. A flag occurs as a comment after the relevant instruction, starting on a new 
line, and is always preceded by 


followed by a brief message, as defined below and summarized in Appendix B. inere are two types of flags, op- 
tional and mandatory. 

7.3.1 Optional Flags 

Optional flags may be suppressed by the user because the appearance of these flags does not necessarily mean 
that changes have to be made to the program. (The method of suppressing optional flags is explained in Chapter 
8.) The Translator may insert optional flags for the conditions described below. 

7.3. 1 . 1 Additional Code - When the Translator generates extra lines of code, a flag may be raised. The two 
situations are: 

DCA A DCA instruction was translated into DAC followed by CLA. 

SMI (Segmented Micro-instruction) - A segmented micro-instruction was encountered 

which could be translated only by splitting it into two instructions. 


7.3. 1 .2 Relative Addresses - Since extra lines of code are generated, any relative address which occurs in the 
program may be in error. 
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REL 


An address followed by ±n (where n is a number) was encountered. 


7.3. 1 .3 Rotate Instructions - Since the word length of the two machines is different, the use of rotate instruc- 
tions may result in incorrect operation. 

ROT A single or double rotate instruction was encountered. 


7.3. 1.4 Undefined Symbols - Since the Translator contains tables of pseudo-operations. Memory Reference, 
Operate, and Teletype and reader/punch I/O instructions only (the latter two being limited to CAP- 15), any 
other symbol encountered in the operation field is undefined. Provision is therefore included to read a User Sym- 
bol Table prior to translation, so that a symbol is not declared undefined until a search of all user symbols has 
been made. 


US An undefined symbol was found in the operation field. 


NOTE 

1) If a User Symbol Table is to be retained for a number 
of tapes, each tape except the last must be terminated 
by a PAUSE pseudo-op. 

2) If a User Symbol Table is not read prior to translation, 
it will be built during translation; hence only forward 
references in the operation field will be flagged. 


7.3.2 Mandatory Flags 

The flags in this group are always typed when applicable. They are generated for the following reasons. 


7. 3. 2.1 Location Counter Settings - The setting of the location counter by PAGE and * is ignored, and the 
code is simply printed as a comment. 

LOC A location counter setting was ignored. 


NOTE 

Each translation is preceded by .ABS and .LOC 100. 


7. 3. 2.2 Illegal Characters - When an illegal character is encountered, its octal value in 7-bit ASCII is output. 
The character is ignored. 
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IC nnn 


Illegal character. 


7. 3. 2.3 Literals - Instructions within literals are translated only if the translation comprises a single line of 
code. Nested literals are illegal in MACRO-15. 

LIT A literal was nested, or, if translated, would have produced extra code. 

7. 3. 2.4 Multiple Precision Constants - Double precision integers (DUBL) and floating-point constants (FLTG) 
have a different representation in PDP-15. They are not translated. 

MPC A DUBL or FLTG pseudo-operation was encountered and ignored. 

7.3. 2.5 Skip Instructions - If the instruction following a Skip instruction is segmented, the Skip will cause an 
error at execution: 

SKP A segmented micro-instruction followed a Skip instruction. 

7. 3. 2.6 Symbol Table Overflow - The symbol table capacity is 1024 symbols in the CAP-15 version, and all of 
the unused core between .SCOM+2 and .SCOM+-3 in the MACRO-15 version. If the symbol table is filled, no 
further symbols will be stored. 

SE Symbol Table Exceeded. 
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CHAPTER 8 
OPERATION 


8TRAN exists in three versions to allow operation in the various PDP-15 software environments. The Advanced 
and Background/Foreground Monitor version uses standard device handlers for I/O functions. The Basic I/O 
Monitor version is similar, differing only in the assignment of device handlers. The COMPACT version operates 
using its own embedded I/O functions. Appendix C provides a typical example of 8TRAN operation in the Ad- 
vanced Monitor Environment. 


8.1 MONITOR VERSIONS 

These versions of 8TRAN are relocatable binary paper tapes which must be loaded either by the Linking Loader 
or DDT. 


8.1.1 . DAT Slot Assignments 

The following .DAT slots are used: 


-15 Input 

-14 Output 

-3 Messages 
-2 Command String 
3 Input 
5 Output 


(Default - DTA2) - Advanced and Background/ 
Foreground version 

(Default - DTAl) - Advanced and Background/ 
Foreground version 


TTA 

TTA 

PRA 

PPA 


- Both versions 

- Both versions 

- Basic I/O Monitor version 

- Basic I/O Monitor version 


NOTE 

The Advanced and Background/foreground version uses 
the system Macro .FSTAT. Any file oriented device 
handler used must recognize .FSTAT, otherwise an 
IOPS6 error will occur. 
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8.1.2 Loading Procedures 


8. 1.2.1 Advanced and Background/Poreg round Environment - When the Monitor is in core, perform the follow- 
ing steps: 

a. Assign .DAT slots (optional). 

b. Type: 

GLOAD ) 

c. When the Linking Loader is in core, it types: 

LOADER Vnn 

> 

d. If using Advanced Monitor, type: 

8TRAN (ALT MODE) 

If using Background/Poreground Monitor, type: 

-- 8TRAN (ALT MODE) 

e. When loaded, 8TRAN types: 

8TRAN Vnn 

> 

and waits for a command string (see Paragraph 8.1 .2.3). 


8. 1.2.2 Basic I/O Monitor Environment - Perform the following steps: 

a. Put the 8TRAN tape in the tape reader. 

b. Set the ADDRESS Switches to 17720 (8K). 

c. Press I/O RESET and READIN. 

d. When loaded, 8TRAN types 

8TRAN Vnn 

> 

and waits for command string (see Paragraph 8. 1.2.3). 


8. 1.2.3 Command String - 8TRAN expects a command string in the following format: 


Options 



See Paragraph 8.1.3 


^ Filename ) or 


Restarts 8TRAN when 
current translation is 
completed . 


(ALT MODE) 


7 


Causes a return to the 
Monitor after translation 
is completed (Advanced 
and Background/Fore- 
ground). 


b. Halts 8TRAN when cur- 
rent translation is complete 
(press CONTINUE to restart). 
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8.1.3 Options 

There are two options in 8TRAN, which may be exercised separately or together: 

§ Read a symbol table prior to translation. 

F Suppress output of flags. 


8.1.3,! Symbol Table - If S is typed, it must be followed by the name of the symbol table file. The file will 
be a symbol table output by either PAL III or MACRO-8. 

Example S ^ SYMTAB J 

The program reads the symbol table, stores it and types 

SYMBOL TABLE READ 

> 

The program now requires the name of the file to be translated, 
e.g., ^MAC8) or (ALT MODE) 

8. 1 .3.2 Flag Suppression - If F is typed, 8TRAN responds by typing FLAGS, after which it waits for the user 
to type any or all of the following 

DCA, REL, ROT, SMI, US, 

to suppress output of the corresponding flags. The flag names may appear in any order, separated by space or 
tab, and terminated by a carriage return. Example: 

FLAGS - DCA US REL) 


8.1.4 Translation 

The program then proceeds to translate the file named in the command string. The file name extension for input 
is assumed to be SRC unless it is given in the command string. The file name extension on output will always be 
SRC irrespective of the extension given in the command string. It is recommended that the extension PAL be 
given to PDP-8 programs so that there will be no confusion between original and translated programs. 
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8.1.5 Other Features 


a. PAUSE - When a PAUSE is encountered, the symbol table is preserved for the translation of other 
tapes. The program types: 

PAUSE 

> 

and waits for another command string, 

b. $ - If a $ is encountered in a translation where the last command string was terminated by ALT 
MODE, either the user is returned to the Monitor (Advanced and Background/Foreground Environment) or 
8TRAN restarts (Basic I/O Monitor Environment). If a $ is encountered when the last command string 
was terminated with J, 8TRAN restarts and types 

8TRAN Vnn 

> 

c. CTRL P - If another translation is required, type CTRL P at any time to cause 8TRAN to restart with 

8TRAN Vnn 

> 


8.1.6 Error Conditions 

a. If the command string is not understood, 

?? 

> 

is typed by the translator; a corrected command string should then be typed by the user. 

b. If the name of the program to be translated is not on the input device, 

INPUT FILE NOT ON DEVICE 

> 

is typed, and the command string must be retyped with the correct name, 

c. If the name of the program (with SRC extension) is already on the output device, 

OUTPUT FILE ALREADY ON DEVICE TYPE tP TO RESTART OR CR TO OVERWRITE 
is typed and the user takes appropriate action. 

d. If an IOPS4 error (I/O device not ready) occurs, type CTRL R when the condition has been corrected. 

e. Refer to the applicable User's Guide or Software System manual for a description and listing of all 
lOPS errors. 


8.2 COMPACT VERSION 

This version of 8TRAN is an absolute binary paper tape which must be loaded using the COMPACT Loader. 


8-4 



8.2.1 Loading Procedure 

Perform one of the following two procedures, depending upon whether you are using the low speed reader (ASR33) 
or the high speed reader (PC-15) as the loading device for the loader. 

a. Low-Speed Reader 

1 . Set the BANK/PAGE switch to PAGE. 

2. Place the tape containing the Low Speed Hardware Readin Binary Loader in the ASR33 reader. 

3. Set the reader switch to ON. 

4. Set the ADDRESS switches to 7700 (17700 8K). 

5. Press I/O RESET and READIN. When the Loader is loaded, the computer will halt with 777777 
in the AC. 

6. Set the reader switch to OFF and place the 8TRAN tape in the ASR33 reader. 

7. Set the reader switch to ON. 

8. Press START. 8TRAN will be loaded. 

b. High-Speed Reader 

1 . Set the BANK/PAGE switch to PAGE. 

2. Place the tape containing the High Speed Hardware Readin Binary Loader in the PCI 5 reader. 

3. Set the ADDRESS switches to 7720 (17720 8K). 

4. Press I/O RESET and READIN. When loading is complete, the computer will halt with 777777 
in the AC. 

5. Place the 8TRAN tape in the PC 15 reader and press START. 8TRAN will be loaded. 


8.2.2 Initialization Sequence 
When 8TRAN is loaded, it types: 

8TRAN Vnn 

and proceeds to type a series of messages as follows: 


Message 

Option 

*IN 

PC 15 or ASR33 


reader input 

*OUT 

PC 15 or ASR33 


punch output 

*SYM 

Symbol Table 


User Types 

H ^To select PC15 
L ) To select ASR33 

^ As above 

Read symbol table. 
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NOTE 


The symbol fable tape must be m fhe reader prtor fo 
fypmg Y, and If must be terminated with an EOT 
(ASCII 04) symbol. When finished, 8TRAN types: 

SYMTAB 

N } No symbol table. 


Message 


Option 


User Types 


*FLG Flag Suppression 


NOTE 

Place the program to be translated in the reader 
before proceeding. 


*DCA 

N ) No suppression, 
proceed with 
translation. 

YJ Select suppression 
option. List 
flags, t 

Y i Suppress. 

*REL 

N ^ Allow. 

Y ) Suppress. 

*ROT 

N ^ Al 1 ow . 

Y ) Suppress. 

*SMI 

N^ Allow. 

Y ) Suppress. 

*US 

N ) Allow. 

Y^ Suppress. 


N) Allow. 


8.2.3 Translation 

Translation proceeds automatically after the carriage return () ) which terminates the response to the *US mes- 
sage or after the carriage return (^ ) following an "N" response to the *FLG message. 8TRAN will restart when 
the current translation is completed. 


tSee Paragraph 7.3 
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8.2.4 Other Features 


a. PAUSE - When a PAUSE is encountered by 8TRAN, the symbol table is preserved for the translation 
of other tapes. The program types: 

PAUSE 

tP 

Place the next tape in the reader and type CTRL P. 

b. CTRL P typed at any other time will cause the program to restart with 

8TRAN 

*IN 

c. $ - When a $ is encountered the program restarts, as above. 

d. The program may be started at location 100. 


8.2.5 Error Conditions 

There are two conditions that will cause the program to halt in the COMPACT environment: 

a. When the PC 15 paper tape punch is out of paper tape, the program halts at location 70 with all 
ones in the AC. To continue, reload tape into the punch and press CONTINUE. 

b. When an interrupt occurs, not caused by the PCI 5 or ASR33, the program halts at location 70 with 
the lORS in the AC. Press CONTINUE to execute a CAF instruction, in an attempt to clear the cause 
of the interrupt. 
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APPENDIX A 
SYMBOL TRANSLATIONS 


PDP-8 


PDP-15 


PDP-8 


PDP-15 


Memory Reference Operate (Cont) 



A-1 



PDP-8 


PDP-15 


PDP-15 


PDP-8 


Input/Outpuf- (Cont) Pseudo Operators 


PCF 



PCF 

PAGE \ 

PSF 



PSF 

FIELD J 

* 


Floating Point 


DECIMAL 

FEXT 



Ignored 

OCTAL 

FADD 



JMS FAD 

DUBL -1 





FLTG J 

FSUB 



JMS FSUB 

TEXT 

FMPY 



JMS FMPY 

PAUSE 

FDIV 



JMS FDVD 

$ 

FGET 



JMS FLAG 

DEFINE 

FPUT 



JMS FDAC 

< 

FNOR 



JMS%FNOR 

> 

I 



XCT 

EXPUNGE 

JMS I 

5 

1 

■JMS FLIP 

FIXMRI 



1 

. 0 

FIXTAB 

JMS I 

6 

j 

■JMS FLOP 




1 

. 6 


JMS I 

7 


Ignored 



A-2 


Ignored 

.DEC 

.OCT 

Ignored 

.SIXBT 

.EOT 

.END 

.DEFIN 

Ignored 

.ENDM 

Ignored 



APPENDIX B 
FLAGS 


Group 

Descriptor 

Meaning 


DCA 

A DCA instruction was translated. 


REL 

A relative address was encountered. 

Optional 

ROT 

A rotate microinstruction was encountered. 


SMI 

Segmented microinstruction. 


US 

An undefined symbol occurred in the 
operation field. 


IC nnn 

An illegal character was encountered and 
ignored. 


LIT 

A literal was nested, or, if translated, 
would have produced extra code. 


LOG 

A location counter setting was ignored. 

Mandatory 

MPC 

A DUBL or FLTG pseudo-operation was 
encountered and ignored. 


SE 

Symbol Table Exceeded. 


SKP 

An SMI followed a Skip instruction. 
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APPENDIX C 
8TRAN DEMONSTRATION 


The appendix consists of a demonstration of 8TRAN operation in the Advanced Monitor environment. The listing 
in the left column is the MACRO-8 source program to be translated. (For the convenience of the reader, addi- 
tional spaces have been inserted in the body of the listing to align the code.) The column on the right on the 
page is an 8TRAN output listing showing the results of translation. 

NOTE 

Summaries of symbol translations and diagnostic flags 
are provided in Appendices A and B respectively. 


MACRO -8 Program 


Translation 


. ARS 






.LOG 

100 

/DIGIT octal 

SOUARR 

Conversational ^ 

/DIGIT octal square 

CONVERS 

/PROGRAM 



/PROGRAM 






-LOG 

*200 


start, pLA 

CLL 


start 

CLA ! CLL 


TuS 



TLS 


JMS 


CRLF 


JMS 

CRLF 

JMS 


LISN 

> 

JMS 

L ISN 

tad 


M260 

tad 

M260 

ral 

CLL 


CLL : RAL 


RTL 



/»* -ROT 



DCA 


MUMBCR 


RTL 


JMS 


L ISN 

/»« -ROT 



Tad 


^260 


DAC 

number 

T ad 


number 

-DCA 



DCA 


number 


CLA 






JMS 

L ISN 





tad 

M260 





TAD 

number 





DAC 

NUMBER 




/«* -DCA 

CLa 



C-1 



mult. 


TYPSQU , 


TYPANS, 


UNPACK, 


TYPOCT, 


MACRO -8 Program 


TranslaHon 


MULT 


TAD 

cma: I AC 
DAC 


NUMBER 

TALLY 


tad 

RAL 

RTL 

GCA 

tad 

AND 

TAD 

JMS 

ISZ 

JMP 


Tad 

DCA 

tad 

OCA 

JMS 

JMS 

JMP 


T AD 

number 


/** -DCA 



CIA 




LAC 

number 

DCA 

tally 



IS? 

TALLY 

Tad 

Number 


> 

JMP 

.-2 

IS? 

TALLY 


/** -REL 



JMP 

.-2 



DAC 

NUMSQR 

DCA 

numsor 


/*o -DCA 







CLA 





TYPSQU 

TAD 

MESAGl 





DAC 

POINTR 

tad 

MESAGl 


, /«« -OCA 



DCA 

POINTR 



LAC 

M10 

tad 

M10 

1 

} 

DAC 

ENDCHK 

DCA 

ENDCHK 

1 

/*» -DCA 



JMS 

MESAGE 

J 


CLA 






JMS 

MESAGE 




TYPANS 

TAD 

M4 





DAC 

OIGCTR 

Tad 

M4 


1 /** -DCA 



DCA 

OIGCTR 

1 


DZM 

STORE 

DCA 

STORE 



LAC 

NUMSQR 

TAD 

NUMSQR 



CLL!RAL 


CLL RAL 



/»» -ROT 






unpack 

Tad 

STORE 


STORE 


STORE 

STORE 

K7 

K260 

TYPE 

niGCTR 

UNPACK 


MESAG2 

POINTR 

M7 

ENDCHK 

MESAGE 

CRLE 

START+2 


/*» -ROT 
/<>* -ROT 
/■»« -DCA 


TYPOCT 

-OCA 

/»» -OCA 

/«* -REL 


RAL 

RTL 

DAC 

AND 

Tad 

JMS 

IS? 

JMP 

Tad 

DAC 

LAC 

DAC 

CLA 

JMS 

JMS 

JMP 


STORE 

K7 

K260 

type 

OIGCTR 

unpack 

MESAG2 

POINTR 

M7 

ENDCHK 


MESAGE 

CRLE 

START>? 
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MACRO-8 Program 


Translation 


TYPE, 


CRLF, 


LISN, 


MESAGE, 


number , 

TALLY, 
NUMSQR , 
MESAGI , 
POINTR, 
M10, 
ENDCHK, 
STORE, 
M4, 

OIGCTR, 

K7. 

M7, 

K260 , 
K212, 
K215, 
MESAG2, 


0 

TSF 

JMP 

TLS 

CLA 

JMS I 

0 

TAD 

JMS 

TAD 

JMS 

JMP I 

0 

KSF 
JMP 
KRR 
TLS 
JMP I 


0 

Tad I 

JMS 

IS? 

IS? 

JMP 
JMP I 
0 

-260 

0 

0 

STARTl 

0 

-10 

0 

0 

-4 

0 

7 

-7 

260 

212 

215 

START2 


.-1 


TYPE 

K215 

TYPE 

K212 

TYPE 

CRLF 


. -1 


L ISN 


POINTR 
TYPE 
POINTR 
FNDCHK 
, -4 

MESAGE 


TYPE 

0 

TSF 


-REL 

JMP 

TLS 

CLA 

.-1 


JMS^^ 

TYPE 

CRLF 

0 



tad 

K215 


JMS 

TYPE 


TAD 

K212 


JMS 

TYPE 


JMP^^ 

CRLF 

LISN 

0 

KSF 


-REL 

JMP 

KRR 

TLS 

. -1 


JMP* 

LISN 

MESAGE 

0 



T AD* 

POINTR 


JMS 

TYPE 


IS? 

POINTR 


IS? 

FNDCHK 

/•»* -REL 

JMP 

. -4 


JMP* 

MESAGE 

number 

0 


M260 

-260 


tally 

0 


NUMSQR 

0 


MESAGI 

-US 

STARTl 


POINTR 

0 


M10 

-10 


ENDCHK 

0 


STORE 

0 


M4 

-4 


OIGCTR 

0 


K7 

7 


M7 

-7 


K260 

260 


K212 

212 


K215 

215 


MESAG2 
/** -US 

START2 



C-3 



MACRO-8 Program 


Translation 


starti , 


START2. 


323 

/S 

starti 

323 

/S 

321 

/Q 


321 

/Q 

325 

/U 


325 

/U 

301 

/A 


301 

/A 

322 

/R 


322 

/R 

305 

/E. 


305 

/F 

304 

/o 


304 

/D 

275 

/ = 

> 

275 

/ = 

240 

/SPACE 

START2 

240 

/SPACE 

317 

/O 


317 

/ Q 

303 

/C 


303 

/c 

324 

/T 


324 

/T 

301 

/A 


301 

/A 

314 

/L 


314 

/L 

256 

/PFRion 


256 

/PFRIOn 


.END 
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INDEX 


A 

.ABS, 7-6 

Absolute binary paper tape, 8-4 

Accumulator Left Shift (ALS), 5-2 

Adding to symbol table prior to assembly, 4-3 

Addition (+) expression operator, 3-2 

Additional code translation, 7-5 

Address 

field, 3-1 
size, 2-2 

Address, relative (Translator), 7-5 
Advanced and Background/Foreground Monitor, 8-1 
loading procedure, 8-2 
Alphanumeric mode, 4-2 
ALS see Accumulator Left Shift 
ALSS see Signed Accumulator Left Shift 
AND (&) expression operator, 3-2 
Arithmetic package, correspondence table, 6-2 
ASCII characters, 7-4 
.ASCII (7-blt ASCII) pseudo-op, 3-3 
ASR33, 8-5 

Assembler symbolic program format, 3-1 
Asterisk (*) 

Multiplication expression operator, 3-2 
PDP-15 Indirect addressing, 3-1 
PDP-8 pseudo-op, 7-3, 7-6 

Auto-Index registers, 2-1, 2-2 

B 

Bank/Page mode, 4-1 
Basic l/O Monitor, 8-1 

loading procedure, 8-2 
Binary mode, 4-2 
Bit 0, 6-1, 6-2 
.BLOCK pseudo-op, 3-2 
Brackets see Macro Defining 


C 

CAF (Clear All Flags) Instruction, 4-1, 8-7 

CAP-15, 1-1, 7-1 

Carriage return, 3-1 

Comma (label terminator), 3-1 

Command string for loading Monitor version, 8-2 

Comment field, 3-1 

COMPACT version, 8-4 

error conditions, 8-7 
Initialization sequences, 8-5 
loading devices, 8-5 
loading procedure, 8-5 
translation, 8-6 

Conflicting event times, 7-3 

Consecutive addresses, 3-1 

Correspondence between memory reference Instructions 
table (mnemonic-octal), 2-1 

CTRL P, 8-4, 8-7 

CTRL R, 8-4 

D 

.DAT slot assignments (Monitor version), 8-1 

Data fields, 2-2 

DCA Instruction flag, 7-5 

DDT (Dynamic Debugging Technique), 8-1 

DECtape 

control word format, 4-2 

controllers, 4-2 

data standard format, 4-2 

DEFINE, 7-3 

Device dependent lOTs, 4-3 

Direct addressing, 2-2 

Division (/) expression operator, 3-2 

Division (DIVS) signed operation, 4-1 

(Dollar Sign) $, 8-4, 8-7 

Double precision constants (DUBL) 

Assembler, 3-2 
Translator, 7-7 



INDEX (Cont) 


Double rotate instructions, 7-3 

DTDF (Skip if DECtape control flag = 1), 4-3 

DTEF (Skip if DECtape error flag = 1), 4-3 

DTSF (Skip if error flag or DECtape flag = 1), 4-3 

E 

EAE (Extended Arithmetic Element) coding, 1-1, 5-1 

correspondence table, 5-1 
word length, 5-1 

8-bit ASCII characters, 3-3 

8TRAN 

demonstration, C-1 
function definition, 1-1 
operation, 8-1 
versions, 8-1 

Error conditions 

COMPACT, 8-7 
Monitor, 8-4 

Exclusive OR ( \) expression operator, 3-2 
Expression operators, MACRO- 15, 3-2 
EXPUNGE pseudo -operator, 3-3 
Extended Arithmetic Element (EAE), 5-1 
Extension PAL, 8-3 

F 

Field delimiter, 3-1 

space, 3-1 
tab, 3-1 

Fields 

address, 3-1 
comment, 3-1 
data, 2-2 
instruction, 2-2 
label, 3-1 
Operation, 3-1 

File name extension, 8-3 

FIXMRI pseudo-op, 3-3 

FIXTAB pseudo-op, 3-3 


Flag suppression, Monitor version operation, 8-3 

Flags, B-1 

Input/output, 4-1 

Flags, Translator 

Mandatory, 7-6 

illegal characters, 7-6 
literals, 7-7 

location counter settings, 7-6 
multiple precision constants, 7-7 
skip instruction, 7-7 
symbol table overflow, 7-7 

Optional, 7-5 

additional code, 7-5 
DCA, 7-5 

relative address, 7-5 
rotate instructions, 7-6 
SMI (segmented micro-instruction), 7-5 
undefined symbols, 7-6 

Floating point 

arithmetic format, 6-1 
constants (FLTG), 3-2, 6-2, 7-7 
correspondence between arithmetic packages 
table, 6-2 

indirect addressing, 6-2 
input/output, 6-2 
instructions, 1-1 
translator, 7-4 
variable storage, 7-5 

FLTG see Floating point constants 

.FSTAT system macro, 8-1 

H 

Highspeed reader (PC-15), 8-5 

I 

Illegal characters (IC), 7-6 
Inclusive OR (!) expression operator, 3-2 
Indirect addressing 
assembler, 3-1 

floating point arithmetic, 6-2 
memory reference instructions, 2-1, 2-2 
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Indirect reference, 3-1 

Indirect references and auto-index registers, 2-1 

Initial character (MACRO-15 Assembler), 3-2 

Initialization sequence (COMPACT), 8-5 

Input/Output (I/O), 4-1 

Floating point arithmetic, 6-2 

Input/Output instructions 

reader/punch, 1-1 
Teletype, 1-1 
translator, 7-2 

Input/Output Read Status (lORS), 4-1 

Input/Output routine calls, 7-4 

Input/Output Transfer instructions (lOT) - 
Teletype, 4-2 

Instruction fields, 2-2 

Integers 

signed, 3-2 
unsigned, 3-2 

Interpreter entry, 7-4 

Interrupt 

buffer, 4-1 

COMPACT environment, 8-7 
function enabled (ION), 4-1 
structure, Input/Output, 4-1 

ION see Interrupt function enabled 

lOPS error, 8-1, 8-4 

lORS see Input/Output Read status 

lOTs in permanent symbol table, 4-3 

lOT (Input/Output Transfer) instructions, 7-2 

J 

JMS FLIP, JMS FLOP, 7-5 

K 

Keyboard flag is cleared (KCC), 4-2 
Keyboard Reader Select (KRS), 4-2 
KRB see Read Keyboard Buffer 


L 

Label field, 3-1, 7-1 
Labels without code, 3-1 
LAW instruction, 2-2 
LAW N mnemonic, 2-2 
Link, 4-1 

Linking Loader, 8-1 

Literals (LIT), 3-3 

nested, 3-3, 7-7 
page zero, 3-3, 7-4 
translator, 7-4 

LLSS see Signed Left Shift 

Loading devices for COMPACT version, 8-5 

Loading procedures. Monitor 

Advanced and Background/Foreground environ- 
ment, 8-2 

Basic l/O Monitor environment, 8-2 
Location counter, 3-2, 7-3 
Location counter settings (LOC), 7-6 
.LOC 100, 7-6 

Low speed reader (ASR33), 8-5 

M 

Macro defining (translator), 7-3 
MACRO-8, 1-1, 7-1 
MACRO-15, 1-1, 7-1 
Mandatory flags. Translator, 7-6 
Mantissae, 6-1 
Memory protect, 4-1 
Memory reference instructions 
Assembler, 3-3 

table, octal -mnemonic correspondence, 2-1 
Translator, 7-1 

Monitor versions operations, 8-1 

MPC see Multiple Precision Constants 

Multiple Precision Constants (MPC), 7-7 

Double precision integers (DUBL), 7-7 
Floating point constants (FLTG), 7-7 
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Multiplication (*) expression operator, 3-2 
Multiplication (MULS) signed operation, 5-1 

N 

Negative mantissae, 6-1 

Nested literals 

Assembler, 3-3 
Translator, 7-7 

Numbers (Assembler), 3-2 

O 

Operate instructions table, correspondence between 
PDP-8and PDP-15, 2-2 

Operate instructions. Translator, 7-3 

Operation field 

Assembler, 3-1 
Translator, 7-1 

Options, Monitor version, 8-3 

P 

Packing of characters, 3-2 
PAGE pseudo-op, 7-3, 7-6 
Paging, 2-2 

Page zero indicator (Z), 7-1 

Page zero literals, 3-3, 7-4 

PAL D, 1-1, 7-1 

PAL III, 1-1, 7-1 

Parameter assignment 

Assembler, 3-3 
Translator, 7-4 

Parameter (P) option, 4-3 

PAUSE (pseudo-op) 

COMPACT version, 8-7 
Monitor version, 8-4 

PC 15 (high speed reader), 8-5 


PC 15 paper tape punch out of tape, 8-7 
Percent sign (%), 3-2 
Period (.), 3-2 

Permanent symbol table lOTs, 4-3 

Pseudo -operators 

.ASCII, 3-3 
*, 7-3, 7-6 
.BLOCK, 3-2 
DUBL, 3-2 
EXPUNGE, 3-3 
FIXMRI, 3-3 
FIXTAB, 3-3 
FLTG, 3-2 
PAGE, 7-3, 7-6 
PAUSE, 7-6 
.SIXBT, 7-3 
TEXT, 7-3 

Pseudo-operations, Translator see Translator pseudo- 
operations 

R 

Reader/punch functions, 4-2 
Reader/punch instructions, 7-2 
Read Keyboard Buffer (KRB), 4-2 
Relative address error (REL), 7-5 
Relocatable binary paper tapes, 8-1 
Rotate instructions (ROT), 7-6 

S 

SE see Symbol table Exceeded 

Segmented micro-instruction (SMI) flag, 7-5, 7-7 

Semicolon (delimiter), 3-1 

7-bit ASCII (.ASCII), 3-3, 7-6 

Shifts in multiplication and division, 5-1 

Accumulator Left Shift (ALS), 5-2 
Signed Accumulator Left Shift (ALSS), 5-2 
Signed Left Shift (LLSS), 5-2 

Signed integers, 3-2 
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Single rotate mstructions, 7-3 

6-bit trimmed ASCII, 3-2 

.SIXBT pseudo-op, 7-3 

Skip if DECtape control flag = 1 (DTSF), 4-3 

Skip if DECtape error flag = 1 (DTEF), 4-3 

Skip if error flag or DECtape control flag = 1 
(DTSF), 4-3 

Skip instructions (SKP), 7-7 
Space, 3-1 

SMI see Segmented micro-instruction 

SRC file name extension, 8-3 

Standard device handlers for l/O functions, 8-1 

Statement delimiter, 3-1 

carriage return, 3-1 
semicolon, 3-1 

Status registers, 4-3 

Subdevice selection. Input/output, 4-1 

Subtraction (-) expression operator, 3-2 

Symbols (Assembler), 3-2 

Symbolic source tape (or file), 7-1 

Symbol table 

MACRO-15, 3-3 
Monitor version, 8-3 

Symbol table 

capacity, 7-7 
exceeded (SE), 7-7 
overflow, 7-7 

Symbol translations, A-1 

T 

Tab, 3-1, 7-1 

Tape standard data format table, 4-3 
TCOl DECtape controller, 4-2 
TC02 DECtape controller, 4-2 
Teletype lOT instructions, 4-2, 7-2 
Terminating pseudo-ops, 3-3 


TEXT pseudo-op, 7-3 

Text handling 

Assembler, 3-2 
Translator, 7-3 

Translation 

COMPACT version, 8-6 
Monitor version, 8-3 

Translator, 7-1 

floating point, 7-4 
input/output instructions, 7-2 
literals, 7-4 

memory reference instructions, 7-1 
operate instructions, 7-3 
pseudo-operations, 7-3 

Translator program 

formats, 7-1 
functions, 7-1 

2's complement, 6-1 

U 

Undefined symbols (US), 7-3, 7-6 
Unsigned integers, 3-2 
User macros correspondence, 3-3 
User symbol table, 7-6 

V 

Versions of 8TRAN 

Advanced and Background/Foreground 
Monitor, 8-1 
Basic l/O Monitor, 8-1 
COMPACT, 8-1 

Z 

Z see page zero indicator 



HOW TO OBTAIN SOFTWARE INFORMATION 


Announcements for new and revised software, as well as programming notes, software problems, and documenta- 
tion corrections are published by Software Information Service in the following newsletters. 


Digital Software News for the PDP-8 Family 
Digital Software News for the PDP-9/15 Family 
PDP-6/PDP-10 Software Bulletin 


These newsletters contain information applicable to software available from Digital’s Program Library. 


Please complete the card below to place your name on the newsletter mailing list. 


Questions or problems concerning DEC Software should be reported to the Software Specialist at your nearest DEC 
regional or district sales office. In cases where no Software Specialist is available, please send a Software Trouble 
Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms, which are available without charge from the Program Library, should be fully filled out and accompa- 
nied by teletype output as well as listings or tapes of the user program to facilitate a complete investigation. An 
answer will be sent to the individual and appropriate topics of general interest will be printed in the newsletter. 


New and revised software and manuals. Software Trouble Report forms, and cumulative Software Manual Updates 
are available from the Program Library. When ordering, include the document number and a brief description of 
the program or manual requested. Revisions of programs and documents will be announced in the newsletters and 
a price list will be included twice yearly. Direct all inquiries and requests to: 

Program Library 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

Digital Equipment Computer Users Society (DECUS) maintains a user Library and publishes a catalog of programs 
as well as the DECUSCOPE magazine for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


Send Digital’s software newsletters to: 

Name 

Company Name 
Address 


My computer is a 

PDP-8/I □ 

PDP-8/L □ 

(zip code) 


LINC-8 □ 
PDP-9 □ 

PDP-12 □ 
PDP-15 □ 

Please specify 

My system serial number is 

PDP-10 □ 

OTHER □_ 
(if known) 
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READER’S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness of its 
publications. To do this effectively we need user feedback — your critical evaluation of this manual. 

Please comment on this manual’s completeness, accuracy, organization, usability, and readability. 


Did you find errors in this manual? 


How can this manual be improved? 


DEC also strives to keep its customers informed of current DEC software and publications. Thus, the following period- 
ically distributed publications are available upon request. Please check the appropriate boxes for a current issue of the 
publication(s) desired. 

□ Software Manual Update, a quarterly collection of revisions to current software manuals. 

D User’s Bookshelf, a bibliography of current software manuals. 

Q Program Library Price List, a list of currently available software programs and manuals. 

Please describe your position. 

Name Organization 

Street Department 

City State Zip or Country 



